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SECTION  1 


INTRODUCTION 


PURPOSE 

The  purpose  of  the  Automated  Requirements  Development  System 
(ARDS)  User's  Manual  is  to  acquaint  users  with  the  ARDS  capabilities 
and  provide  sufficient  Information  for  them  to  use  ARDS 
independently. 

This  volume  of  the  user's  manual  contains  information  about  the 
ARDS  Document  Analysis  capabilities.  Other  ARDS  capabilities  that 
support  the  management  of  comments  on  a  specification  have  been 
developed  and  can  be  reviewed  in  volume  2  of  the  manual. 

Capabilities  that  support  the  initial  generation  of  a  requirements 
specification  are  being  developed  and  will  be  made  available  in 
later  versions  of  the  system  and  the  manual. 

This  manual  provides  a  brief  overview  of  the  ARDS  Document 
Analysis  capabilities  and  describes  how  they  can  be  used  to  support 
ESD  program/project  work  in  sections  1  and  2.  Section  3  contains 
information  on  how  to  access  Document  Analysis  and  how  to  use  the 
system.  Sections  A  and  5  contain  procedures  for  using  batch  and 
on-line  Document  Analysis,  respectively.  Section  6  contains  a  set 
of  the  hard  copy  products. 

The  ARDS  developers  are  interested  in  your  comments  on  both  the 
ARDS  system  and  the  user's  manual.  We  are  also  interested  In  your 
suggestions  for  improvement  or  extension  of  £he  capabilities. 

Please  phone  any  of  the  authors  or  send  UNIX  mail  to  "ards"  (see 
section  3,  REPORTING  ERRORS  AND  SUGGESTIONS). 

WHAT  IS  ARDS? 

The  Automated  Requirements  Development  System  is  a  set  of 
software  tools  that  support  the  requirements  development 
activities  for  ESD  system  acquisition  programs. 

Much  of  the  requirements  related  work  performed  in  ESD  system 
acquisition  consists  of  generating,  reviewing,  revising,  and 
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analyzing  written  specifications  and  other  program  documents.  ARDS 
provides  information  to  help  perform  these  tasks  and  capabilities 
for  manipulating  digitized  documents.  It  helps  improve  productivity 
and  produce  quality  for  both  engineers  and  secretaries. 

Three  major  functions  are  supported  by  ARDS: 

Document  Analysis  tools  include  programs  to  check  for  spelling 
and  typographical  errors;  to  check  paragraph  numbering;  to 
generate  a  table  of  contents;  to  check  internal  paragraph 
references;  and  to  check  external  document  references.  A  word 
and  locate  capability  supports  analysis  of  a  document  for 
aistency  of  terminology. 

S  ^xflcation  Generation  tools  support  the  initial  preparation 
specification.  They  consist  of  a  data  base  of  text  useful 
2  preparation  of  specifications  and  automated  aids  for 
t  ing  the  tailored  text  and  for  generating  a  draft 

document . 

Specification  Review  tools  support  logging,  merging,  and 
sorting  comments  from  various  agencies  to  coordinate  the  review 
process,  including  the  capability  to  produce  an  integrated  set 
of  formal  comments. 

ARDS  runs  on  the  MITRE-Bedford  UNIX  facility.  It  is  accessed 
through  various  terminals  by  cable,  phone  line  or  ARPANET 
connections.  Interfaces  with  the  WORD-1 1  word-processing  system  and 
DEC  stand-alone  word  processors  allow  documents  to  be  moved  between 
them  and  the  MITRE-Bedford  UNIX  system  so  that  ARDS  tools  can  be 
used  on  documents  generated  and  maintained  in  different  systems. 
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SECTION  2 


OVERVIEW 


(ODES  OF  OPERATION 

The  ARDS  Document  Analysis  capabilities  are  available  in  two 
modes,  on-line  and  batch.  The  products  of  the  analysis  are 
ssentially  the  same  in  the  two  modes. 

The  on-line  mode  offers  an  easy- to-use  display  interface  for  the 
iser  to  request  an  analysis  and  review  the  results  of  the  analysis  at 
i  VT100  or  VT103  terminal.  It  also  automatically  prints  a  complete 
et  of  products.  It  is  intended  for  the  local  ESD/MITRE  user  who  is 
ot  familiar  with  the  UNIX  system. 

The  batch  mode  offers  a  simple  way  of  requesting  an  analysis  of 
document  and  of  getting  a  hard  copy  or  a  file  copy  of  the  products, 
t  is  intended  for  use  by  people  who  want  only  hard  copy  products, 

■ho  do  not  have  access  to  a  VT100  or  VT103  terminal  or  who  are 
■Gated  remote  from  the  MITRE-Bed ford  UNIX  computer  facility. 


APABILITIES 

An  overview  of  the  ARDS  Document  Analysis  capabilities  is 
iresented  in  the  text  that  follows: 

v'urd  Check 


Word  Check  aids  in  the  detection  and  the  correction  of  spelling 
nd  typographical  errors.  The  Word  Check  capability  of  Document 
nalysis  checks  all  words  (spaced  symbol  groups)  in  a  document. 

■ords  that  are  not  recognized  by  the  dictionary  fall  into  two 
ategorles.  Some  words  are  listed  as  possible  acronyms.  The 
emainder  of  the  words  are  listed  as  doubtful.  If  a  doubtful  word  is 
^.tually  correct,  you  can  include  the  word  in  the  dictionary. 

aragraph  Check 

For  documents  with  numbered  paragraphs,  Document  Analysis  can 
el p  you  ensure  that  they  are  numbered  correctly.  Document  Analysis 
aragraph  Checking  will  detect  any  paragraph  number  that  is  not  in  a 
roper  ascending  numeric  order  throughout  the  document.  A  listing  of 
hese  errors  is  generated  for  your  review  and  correction. 
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Reference  Check 


Document  Analysis  permits  the  checking  of  two  types  of 
referencing: 

Paragraph  references  within  the  document,  where  one 
paragraph  may  refer  to  another  by  number. 

External  references,  where  the  text  refers  to  other 
relevant  documents. 

For  documents  with  numbered  paragraphs,  where  one  paragraph  may 
reference  another  by  number,  Document  Analysis  can  help  you  ensure 
that  those  references  are  correct.  The  Document  Analysis  paragraph 
reference  generates  three  types  of  listings: 

Wrong  references,  i.e.,  to  paragraphs  that  do  not  exist, 

Paragraph  references  from  other  paragraphs  (this  listing 
is  useful  when  paragraph  numbers  in  the  document  may  be 
changing) ,  and 

Paragraph  references  to  other  paragraphs. 

If  your  document  lists  references  to  other  documents  in  a 
defined  location  (e.g.,  section  2.0  of  a  system  specification), 
Document  Analysis  will  check  discrepancies  In  referencing.  That  is 
to  say,  the  analysis  will  determine  if  there  are  references  in  the 
text  which  do  not  appear  in  the  reference  list,  and  vice  versa. 

Table  of  Contents 

For  documents  with  paragraph  numbers.  Document  Analysis  will 
generate  a  table  of  contents,  listing  paragraphs  by  number,  title 
and  page  In  the  document. 

CONCEPT  OF  DOCUMENT  ANALYSIS  USE 

The  Document  Analysis  capabilities  of  ARDS  enable  both  authors 
and  reviewers  to  check  and  improve  the  accuracy  and  consistency  of 
specifications  and  other  documents.  A  copy  of  a  document  prepared 
on  any  one  of  various  local  word-processing  systems  (DEC  stand-alone 
word  processors  and  WORD-11)  is  transferred  to  Document  Analysis 
where  a  set  of  analyses  is  done.  The  results  of  the  analysis,  which 
identify  errors  and  possible  errors,  are  used  to  edit  and  correct 
the  document  in  Its  home  word-processing  system. 


IT 


The  paragraphs  that  follow  contain  a  description  of  how 
Document  Analysis  can  be  applied  to  the  analysis  of  a  document.  For 
the  purpose  of  this  discussion,  let  us  assume  that  the  document  is  a 
requirements  specification  generated  in  WORD-11  and  that  the 
document  is  being  analyzed  in  a  batch  mode. 

When  the  specification  has  been  entered  into  WORD-11  and  is 
ready  for  analysis,  the  user  transfers  (copies)  the  document  to  the 
MITRE/UNIX  facility.  After  the  document  has  been  transferred,  the 
user  logs  into  a  UNIX  account  and  prepares  the  document  for  Document 
Analysis.  The  user  enters  the  ARDS  system  and  requests  that  the 
document  be  analyzed.  In  about  thirty  minutes  the  user  picks  up  the 
Document  Analysis  products  from  the  computer  center.  The  Document 
Analysis  products  consist  of  the  following  types  of  reports:  Word 
Check,  Paragraph  Check,  Reference  Check,  and  Table  of  Contents.  Now 
let  us  look  at  how  each  of  these  reports  can  support  the  analysis 
and  revision  of  a  document. 

The  Document  Analysis  word-checking  capability  aids  in  the 
detection  and  correction  of  spelling  and  typographical  errors.  This 
capability  generates  a  list  of  words  that  are  not  recognized  by  the 
UNIX  system  dictionary  as  being  correct  (doubtful  words).  The  user 
reviews  the  ARDS  doubtful  words  location  listing,  along  with  a  copy 
of  the  specification  to  determine  if  any  of  the  doubtful  words  are 
actually  good  words.  If  good  words  are  found,  they  are  marked  as 
such  on  the  doubtful  words  listing  for  later  inclusion  in  the 
dictionary.  After  reviewing  the  Word  Check  reports,  the  user  is 
ready  to  update  the  document  and  the  project  dictionary.  The 
document  is  updated  by  correcting  the  misspellings  and  typographical 
errors  in  WORD-11.  The  user  then  contacts  the  ARDS  support 
personnel  for  a  dictionary  update  so  that  the  next  time  the  document 
is  analyzed  by  Document  Analysis,  those  words  will  be  recognized  as 
good  words. 

The  alphabetical  list  of  all  words  in  the  document  is  used  to 
detect  terminology  problems  in  the  document.  For  example,  a  search 
for  obsolete  words  in  the  list  can  be  performed.  If  they  are  found, 
the  location  of  each  occurrence  can  be  obtained  as  a  special 
product . 

When  the  spelling,  typographical,  and  terminology  errors  have 
been  resolved,  the  user  is  ready  to  verify  the  accuracy  of  the 
paragraph  numbers.  This  is  done  by  reviewing  the  paragraph  check 
report.  This  report  indicates  which  paragraphs  are  not  in  the 
proper  ascending  number  sequence.  In  addition,  the  report  indicates 
the  page  number  and  line  number  where  the  error  was  found.  The  user 
may  also  want  to  review  the  Document  Analysis  generated  Table  of 
Contents  to  aid  in  the  detection  of  possible  paragraph-numbering 
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errors.  The  Paragraph  Check  report,  the  Document  Analysis  generated 
Table  of  Contents  and  a  copy  of  the  specification  can  be  used  to 
determine  what  corrections  should  be  made  to  the  specification  in 
WORD-11. 

The  Reference  Check  products  aid  in  the  detection  of  errors 
associated  with  paragraph  and  external  references  in  a 
specification.  Paragraph  references  are  those  references  made  by 
one  paragraph  to  another  paragraph.  The  Paragraph  Reference  check 
report  can  help  the  user  ensure  that  there  are  no  references  to 
non-existing  paragraphs.  This  product  includes  a  list  of  references 
to  paragraphs  that  do  not  exist,  a  list  of  paragraphs  that  are 
referred  to  by  other  paragraphs  and  a  list  of  paragraphs  that  refer 
to  other  paragraphs.  These  listings  are  particularly  helpful  when 
the  document  is  being  revised  and  paragraphs  are  added  and  deleted. 
External  references  are  other  documents,  such  as  military 
specifications  and  standards.  They  are  listed  in  section  2  of  the 
requirements  specification.  The  products  indicate  which  documents 
in  section  2  have  not  been  referenced  elsewhere  in  the  specification 
and  should,  therefore,  be  deleted  from  section  2.  In  addition,  this 
product  lists  those  documents  that  have  been  found  in  the  text  but 
not  listed  in  section  2  and  should,  therefore,  be  added  to 
section  2. 

The  Document  Analysis  Table  of  Contents  is  a  product  generated 
from  the  user's  specification  text.  A  review  of  this  product  can 
assist  the  user  in  getting  a  general  overview  of  the  document  and  in 
determining  if  paragraphs  have  been  omitted.  In  addition,  the 
Document  Analysis  generated  Table  of  Contents  can  be  used  to  ensure 
the  accuracy  of  a  manually  generated  Table  of  Contents.  Further, 
the  Document  Analysis  generated  Table  of  Contents  can  be  included  in 
the  specification  the  user  is  generating.  After  the  Document 
Analysis  generated  Table  of  Contents  has  been  reviewed,  along  with 
the  specification,  the  user  should  make  the  appropriate  corrections 
in  WORD-11. 

Once  these  corrections,  as  well  as  others  that  might  be 
necessary,  have  been  made  in  WORD-11  and  a  next  version  is  ready, 
the  document  is  analyzed  by  Document  Analysis  again  to  ensure  that 
no  new  errors  have  been  introduced. 
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SECTION  3 


HOW  TO  USE  DOCUMENT  ANALYSIS 


GETTING  A  COMPUTER  ACCOUNT 

The  first  step  for  a  new  Document  Analysis  user  Is  to  get  a  UNIX 
account  by  calling  the  User  Support  Center  at  617-271-2222. 

TERMINAL  TYPES 

The  Document  Analysis  on-line  interface  is  limited  to  use  on  the 
DEC  VT100  and  VT103  terminals. 

The  Document  Analysis  batch  capability  can  be  used  at  any 
terminal  that  can  access  the  MITRE-Bed f ord  UNIX  facility. 

TAILORING  A  DOCUMENT  FOR  DOCUMENT  ANALYSIS 

In  order  to  apply  Document  Analysis  to  a  document,  the  document 
must  be  tailored  to  adhere  to  the  following  characteristics: 

Contain  no  table  of  contents,  requirements  verification 
matrix,  list  of  figures,  list  of  illustrations,  etc.,  if 
they  have  numbers  that  look  like  paragraph  numbers. 

Have  page  numbers  that  are  centered,  Arabic  numbers 
containing  no  special  characters.  The  page  numbering 
allows  for  figures  and  tables  not  included  in  the 
document . 

Is  a  single-spaced  document  with  double-spacing  between 
paragraphs . 

Document  Analysis  products,  such  as  the  table  of  contents,  can 
be  used  as  part  of  you  document.  If  you  wish  to  use  the  table  of 
contents  as  part  of  your  document,  an  analysis  must  be  performed 
after  final  editing  is  completed.  WORD-11  users  should  see  appendix 
A,  HOW  TO  GET  THE  FINAL  WORD-11  DOCUMENT. 
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TRANSFERRING  DOCUMENTS  TO  UNIX 

Documents  generated  In  other  word-processing  systems  must  be 
transferred  Into  the  UNIX  system  before  the  ARDS  tools  can  be  used 
on  them.  The  procedures  for  transferring  documents  from  WORD-11  and 
DEC  stand-alone  word  processors  are  found  in  appendices  B  and  D, 
respectively.  Transfers  from  other  word-processing  systems  can  be 
arranged.  If  you  need  additional  help  in  transferring  your 
documents,  contact  the  ARDS  support  personnel  at  617-271-7864. 


LOGGING  ON  TO  THE  SYSTEM 

Turn  the  terminal  on.  On  VT100  and  VT103  terminals  the 
"ON/OFF"  switch  is  on  the  back  left  side.  The  cursor  will  appear 
when  the  power  is  on. 

Enter  a  carriage  return  (indicated  by  <CR>  in  these 
instructions).  If  the  system  prompts  you  as  follows  with: 

MITRE  System  //? 


your  response  is: 


1  <CR> 

to  select  the  MITRE-Bedford  UNIX  Facility. 

If  the  system  prompts  you  with: 

Enter  MITRENET  Service  Name 


your  response  is: 


unix  <CR> 

to  select  the  MITRE-Bedford  UNIX  Facility.  The  system  will  respond 
with  several  Information  messages,  but  wait  for  the  login  message 
before  entering  anything. 

When  "login:"  appears,  type  in  your  account  name  and  enter 
"<CR>".  The  system  will  then  ask  for  the  password.  Enter  the 
password  (the  password  does  not  show  on  the  screen)  and  enter 
"<CR>”.  If  the  login  or  the  password  is  incorrect,  the  system  will 
repeat  the  login  sequence  until  you  give  the  correct  information. 
When  the  login  is  complete,  the  system  will  respond  with  a  message 
from  the  computer  center.  You  can  enter  a  command  when  the  prompt 
(2)  appears. 
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UNIX  Timeout 


If  you  do  not  start  to  login  within  30  seconds,  the  connection 
will  "timeout"  issuing  the  message: 

Timeout  -  Disconnect 
90)  gl 

Disconnection  Complete 

If  "Busy,  Wait?  nnn"  appears,  then  all  ports  to  the  MITRE-Bedford 
UNIX  Facility  are  busy.  “nnn"  indicates  your  position  in  the 
queue.  If  you  enter 


n  <CR> 

to  indicate  that  you  do  not  wish  to  wait,  you  will  get  the  message: 

DISCONNECTED 
Disconnection  Complete 

Entering  a  carriage  return  after  a  disconnect  will  prompt  you  with: 

MITRE  System  //? 


or 


Enter  MITRENET  Service  Name 
If  you  wish  to  wait  for  a  port  to  free  up,  enter: 

y  <CR> 

the  system  will  respond  with  either: 

WAITING 

which  means  you  will  be  soon  connected  or: 

Queue  full,  disconnected 

If  you  wish  to  terminate  the  waiting,  the  break  key  or 
attention  key  can  be  hit  three  (3)  times  slowly  followed  by  a  "<CR>" 
to  return  to  "MITRE  System  #?".  If  you  are  connected  to  MITRENET, 
depress  the  SET-UP  key  followed  by  the  number  "0"  to  return  to  the 
"Enter  MITRENET  Service  Name". 


PREPARING  DOCUMENTS  FOR  DOCUMENT  ANALYSIS 


Before  a  document  can  be  analyzed  by  ARDS,  the  document  must 
adhere  to  the  format  requirements  of  Document  Analysis.  The  format 
requirements,  which  are  met  by  the  document  preparation  program, 
"doc. prep",  are  as  follows: 

Left  margin  removed, 

Underscored  text  Is  changed  to  Document  Analysis  pseudo 
underscoring,  i.e.,  leading  "$#"  and  ending 

Removal  of  control  characters,  such  as,  backspaces,  tabs, 
and  carriage  returns,  and 

Primary  paragraph  numbers  moved  to  column  one. 

The  document  preparation  program,  “doc. prep”,  will  generate  a 
copy  of  your  document  that  will  adhere  to  the  Document  Analysis 
format  requirements.  Prior  to  executing  the  program,  the  user  must 
determine  the  number  of  leading  blanks  (left  margin)  in  the 
document.  The  user  is  now  ready  to  execute  the  document  preparation 
program.  This  is  done  by  entering  the  command: 

doc. prep  <CR> 

You  will  be  prompted  with: 


ARDS  Document  Preparation  Program 

Select  the  code  of  the  word  processor  from  which  this 
document  was  transferred. 

w  =*  WORD- 11 
d  =  DEC  Word  Processors 
n  =  UNIX  nroff 
o  «  Other 

Enter  here: 


Enter  the  code  that  represents  the  word-processing  system  that  was 
used  to  prepare  your  document.  If  your  word-processing  system  is 
not  represented,  enter  the  letter  "o". 
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For  users  entering  "o“ ,  your  document  will  be  prepared  using  a 
general  preparation  program.  You  will  find  that  titles  in  the  table 
of  contents  generated  from  documents  prepared  in  this  way  are 
limited  to  one  line.  The  user  will  be  given  the  option  to  continue 
with  the  preparation  or  terminate  the  document  preparation  program. 

If  the  word  processor  that  was  used  to  generate  your  document 
was  represented  by  "o'"  and  you  decide  to  continue,  you  will  be 
prompted  with: 


Enter  the  name  of  your  word  processor. 

After  the  word  processor  has  been  identified,  you  will  be  asked 
to  enter  the  name  of  your  document  file.  When  prompted  with: 

Enter  the  name  of  the  document  file: 

enter  the  name  of  your  document  file.  The  output  of  the  document 
preparation  program  is  the  name  entered  plus  the  characters  "ards". 
This  file  is  used  as  input  to  batch  or  on-line  Document  Analysis. 

You  will  also  be  asked  to  enter  the  left  margin  setting  of  your 
document.  If  you  do  not  know  the  left  margin  setting,  you  should 
terminate  the  program.  Once  the  left  margin  setting  has  been 
determined,  you  can  execute  "doc. prep"  again. 

EXECUTING  DOCUMENT  ANALYSIS 

Document  Analysis  can  be  executed  in  two  modes:  batch  and 
on-line.  The  text  below  describes  how  to  execute  each  mode: 

Batch  Document  Analysis 

An  analysis  of  a  document  in  your  account  can  be  done  via  batch 
Document  Analysis  from  any  UNIX  terminal.  This  is  done  by  entering 
the  command: 

batch. ards  <CR> 


Section  4  of  this  manual  gives  a  detailed  description  of  this 
command.  Section  6  of  this  manual  contains  examples  of  the  Document 
Analysis  products. 


On-Line  Document  Analysis 


An  analysis  of  a  document  in  your  account  can  be  done  via 
on-line  Document  Analysis  if  you  have  VT100  or  VT103  terminal.  This 
is  done  by  entering  the  command: 

ards  <CR> 

Once  in  ARDS  you  are  requested  to  enter: 

d  <CR> 

for  the  ARDS  Document  Analysis  Options  Display.  This  is  the  display 
that  takes  you  to  the  different  capabilities  of  Document  Analysis, 
such  as.  Word  Check,  Paragraph  Check,  Reference  Check,  and  Table  of 
Contents.  Section  5  contains  prints  of  some  of  the  displays  you 
will  encounter  using  on-line  Document  Analysis.  Section  6  of  this 
manual  contains  examples  of  the  Document  Analysis  products. 

When  you  have  finished  using  Document  Analysis,  you  enter: 

o  <CR> 

to  return  to  the  ARDS  Main  Menu  and  then  enter: 

e  <CR> 


to  exit  ARDS. 

LOGGING  OFF  THE  SYSTEM 

When  you  have  finished  using  Document  Analysis,  you  log  out  of 
the  UNIX  system  by  entering: 


logout  <CR> 


OBTAINING  HARD  COPIES 

You  will  normally  get  a  set  of  printouts  when  you  analyze  a 
document  in  Document  Analysis.  You  can  also  request  printouts  by 
entering  the  "p"  option  at  different  places  in  on-line  Document 
Analysis.  Hard  copies  can  be  picked  up  at  the  MITRE-Bedf ord 
Computer  Center  approximately  thirty  minutes  after  they  are 
requested.  The  printout  will  contain  ar.  ARDS  banner  followed  by  the 
Document  Analysis  products.  The  ARDS  banner  will  indicate  the 
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account  in  which  the  document  was  analyzed,  the  project  charged,  the 
name  of  the  document  analyzed,  and  the  date  and  time  the  document 
was  analyzed. 


READING  YOUR  MAIL 

After  the  analysis  of  a  document  is  completed,  you  will  receive 
mall  indicating  when  and  where  the  Document  Analysis  products  can  be 
secured.  When  you  have  mail,  the  UNIX  "mail"  program  will  prompt 
you  with: 


You  have  mail. 


To  read  your  mail,  enter: 


mail  <CR> 

The  "mail"  program  will  prompt  you  with  lines  similar  to: 

/usr/spool/mail/ards  1  message  1  new 

>N  1  ards  Tues  May  3  12:02  10/240 

& 

NOTE:  Some  accounts  may  have  been  setup  to  execute  the  mail  command 

during  the  logging  in  process.  If  your  account  has  been 
setup  this  way,  you  will  receive  the  lines  above  without 
entering  the  mail  command. 

To  read  the  mail,  enter: 


t  <CR> 

Your  mail  will  be  displayed  at  your  terminal.  When  prompted  again 
with  enter: 

d  [message  number)  <CR> 

to  delete  the  mail  you  have  just  read.  To  exit  the  "mail"  program, 
enter: 


q  <CR> 
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REPORTING  ERRORS  AND  SUGGESTIONS 


The  ARDS  user  can  report  any  errors  and  make  any  suggestions 
regarding  Document  Analysis  via  the  UNIX  "mail"  program.  To  send 
"mail"  to  the  ARDS  support  group,  enter: 

mail  ards  <CR> 


When  prompted  with: 


Subject : 


enter: 


document  analysis  <CR> 

Now  enter  your  message  (error  or  suggestion).  To  terminate  the  mail 
program  and  send  the  "mail"  to  the  ARDS  support  group,  enter: 

<CTRL>  d 

(The  symbol,  <CTRL>,  means  to  hold  the  "CTRL"  key  while  entering  the 
letter  that  follows.)  You  will  be  prompted  with: 

EOT 

This  indicates  that  the  end-of-text  has  been  detected.  You  are  now 
ready  to  enter  your  next  UNIX  command. 

ANALYZING  CLASSIFIED  DOCUMENTS 

Classified  documents  can  be  analyzed  at  the  ARDS  Computer 
Facility  during  normal  working  hours.  The  current  transfer  medium 
for  classified  documents  are  nine-track,  magnetic  tape  and  DEC 
stand-alone  word  processors.  Procedures  for  transferring  documents 
from  other  word  processors  will  be  defined  as  needed.  You  should 
contact  the  ARDS  support  personnel  for  classified  analyses  far 
enough  in  advance  to  ensure  proper  planning  for  your  word  processor 
and  the  scheduling  of  computer  time.  The  ARDS  support  personnel  can 
be  reached  at  617-271-7864. 


ASSUMPTIONS  DOCUMENT  ANALYSIS  MAKES  ABOUT  DOCUMENTS 

When  you  review  your  Document  Analysis  products,  you  may  find 
unexpected  results.  These  are  often  caused  by  differences  between 
the  actual  content  or  format  of  the  analyzed  document  and  what 
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Document  Analysis  expects.  The  following  paragraphs  indicate 
assumptions  that  Document  Analysis  makes  about  the  document. 

Paragraph  Checking 

The  following  assumptions  are  made  about  the  paragraphs  and 
paragraph  numbers  in  the  document  being  checked: 

A  string  of  characters  is  recognized  as  a  paragraph 
number  if  it  consists  of  digits  and  periods  only,  if  it 
has  at  least  one  digit  and  one  period,  and  if  there  are 
no  more  than  two  consecutive  digits. 

The  following  are  examples  of  paragraph  numbers:  2.0, 

1.,  4.13.8.  The  following  are  examples  of  unacceptable 
paragraph  numbers:  6. 2. a,  4.128. 

A  paragraph  number  that  identifies  a  paragraph  begins  in 
the  leftmost  column  of  text. 

A  paragraph  is  preceded  by  at  least  one  blank  line  in  the 
text. 

Internal  Paragraph  Referencing 

A  string  of  characters  is  recognized  as  a  paragraph  number  if 
it  consists  of  digits  and  periods  only,  if  it  has  at  least  one  digit 
and  one  period,  and  if  there  are  not  more  than  two  consecutive 
digits . 

If  figure  and  table  numbers  have  the  same  form  as  paragraph 
numbers,  then  references  to  them  may  be  interpreted  as  references  to 
paragraph  numbers.  However,  references  to  figures  or  tables  having 
the  same  number  as  the  paragraph  in  which  the  references  occur  are 
ignored . 


External  Referencing 

Document  references  in  the  text  of  a  document  are  located  by 
searching  for  known  document  prefixes.  The  following  list  of 
prefixes,  which  can  be  extended  at  user  request,  is  used: 
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AFM 

DOD 

AFR 

T.O 

FED 

DCAC 

MIL 

ANSIX 

AFSC 

JANAP 

DIAM 

GA 

RADC 

FIPS 

SDSP 

STDN 

AFNAG 

MM 

NORAD 

JSC 

NORADM 

ME 

NORADR 

EIA 

NACSEM 

A  document  reference  In  the  list  (of  applicable  documents, 
section  2,  of  a  Type  A  Specification)  with  a  letter  suffix  is 
considered  to  match  a  reference  in  the  text  without  a  letter  suffix, 
but  otherwise  the  same. 

Words 

A  word  is  a  string  of  one  or  more  alphanumeric  characters 
enclosed  at  each  end  by  one  or  more  non-alphanumer ic  characters. 

The  exceptions  are:  a  period  (.)  and  an  apostrophe  (')  which  do  not 
define  the  end  of  a  word  if  followed  by  an  alphanumeric  character. 

A  word  that  starts  with  a  digit  is  not  included  In  the  word  list. 

The  following  are  examples  of  words:  line,  name .version , 
user's . 

The  following  are  examples  of  word  rejects:  124,  3.1.3,  300KB. 

When  Document  Analysis  is  searching  for  words  in  the  text  of  a 
document,  hyphens  at  the  end  of  a  line  of  text  are  removed  and  the 
character  string  at  the  end  of  one  line  is  pushed  together  with  the 
character  string  at  the  beginning  of  the  next  line  to  form  a  single 
word.  If  a  hyphen  in  a  hyphenated  word,  such  as,  "on-line"  occurs 
at  the  end  of  the  line,  it  will  be  mistaken  for  an  end  of  the  line 
hyphen  and  removed.  As  a  result,  the  word  listed  will  be  "online" 
instead  of  "on-line".  Unusual  results  occur  when  words  in  tabular 
materials  are  hyphenated;  information  from  different  columns  will  be 
joined  . 

The  lower  case  and  initial  capital  versions  of  a  word  are 
considered  to  be  two  different  words  in  the  word  list. 


Location  of  Words 


When  a  hyphenated  word  Is  spilt  at  the  end  of  a  line  at  a 
hyphen  and  the  hyphen  is  removed  to  form  a  word,  as  explained  above, 
the  line  of  text  shown  in  the  "locate"  printout  will  be  the  line  on 
which  the  last  part  of  word  occurs. 

Ac  ronyms 

An  acronym  is  a  word  that  consists  of  two  or  more  characters 
and  that  begins  with  a  capital  letter  and  ends  with  one  of  the 
following:  a  capital  letter,  or  a  capital  letter  followed  by  "s" , 

or  "*s”  or  a  number. 
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SECTION  4 


BATCH  DOCUMENT  ANALYSIS 


GETTING  STARTED 

If  you  are  an  experienced  UNIX  user,  you  should  go  to  the 
paragraph,  USING  BATCH  DOCUMENT  ANALYSIS. 

Prior  to  executing  the  batch  mode  of  Document  Analysis  command, 
you  need  to  know  your  full  pathname.  You  can  determine  the  full 
pathname  of  the  document  by  entering  the  command: 

pwd  <CR> 

Your  current  pathname  will  be  printed,  for  example: 

/ul/ards 

The  results  of  the  "pwd"  command  plus  a  "/"  and  your  document 
name  is  the  full-path  name  of  your  document.  If  the  document  name 
is  "testards",  the  full-path  name  of  your  document  will  be: 

/ul/ards/ testa rds 

When  you  enter  the  "batch. ards"  command,  the  system  will  respond 
with: 


Enter  the  full-path  name  of  your  document: 

After  executing  the  batch  Document  Analysis  command,  you  will  see  on 
the  screen  a  prompt.  You  can  now  logout  of  UNIX  by  entering: 

logout  <CR> 

After  about  thirty  minutes,  log  into  the  UNIX  account  again.  If  the 
Document  Analysis  has  been  completed,  you  will  receive  a  UNIX  system 
message  Indicating  that  you  have  mail.  To  read  the  mail,  see 
section  3,  READING  YOUR  MAIL. 
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USING  BATCH  DOCUMENT  ANALYSIS 


You  can  request  an  analysis  of  your  document  from  any  UNIX 
terminal  by  executing  the  command: 

batch. ards  <CR> 

The  system  will  respond  with: 

Enter  the  full-path  name  of  your  document: 

NOTE:  Only  document  files  in  your  current  login  account  may  be 

analyzed . 

When  prompted  with: 

p  =  Print  the  products 
s  =  Store  the  products  in  a  file 
b  =  Both  of  the  above 

Enter  p,  s  or  b  for  the  desired  output  mode: 

select  the  desired  output  mode.  If  you  select  the  "p"  option,  the 
Document  Analysis  products  can  be  picked  up  at  the  Bedford  Computer 
Center.  The  Document  Analysis  products  can  be  printed  at  any  hard 
copy  terminal  if  the  "s”  option  is  selected.  The  name  of  the  file 
in  which  the  products  are  stored  will  be  the  name  of  your  document 
file  plus  the  characters  "all". 

After  you  have  selected  the  output  mode,  the  analysis  is  begun 
and  you  can  execute  other  UNIX  commands  as  soon  as  you  get  the 
prompt  (%). 

The  time  that  the  analysis  takes  depends  on  the  size  of  your 
document  and  the  load  on  the  UNIX  system.  You  will  receive  mail  via 
the  UNIX  mail  system  when  the  analysis  has  been  completed. 

To  minimize  computer  costs,  you  should  remove  unnecessary 
files.  If  the  document  was  not  generated  in  UNIX,  the  file 
containing  the  document  and  the  file  containing  the  products  should 
be  deleted.  The  results  of  "doc. prep”  should  remain  in  your  account 
until  you  are  sure  that  you  do  not  want  any  other  listings  from  that 
document . 


SAMPLE  PRODUCTS 


The  products  below  are  generated  via  batch  Document  Analysis. 
An  example  of  each  product  is  found  on  the  pages  indicated. 


TABLE  OP  CONTENTS  51 

PARAGRAPH  CHECK 

Paragraphs  Not  in  Correct  Ascending 

Numeric  Sequence  5 7 

PARAGRAPH  REFERENCING 

Refers  TO  59 

Referred  TO  BY  6J 

References  To  Non-existing  Paragraphs  65 

EXTERNAL  REFERENCING 

Discrepant  References  6V 

All  External  References  66 

WORD  CHECK 

Word  List  7 5 

Acronym  Check  66 

Doubtful  Words  List  92 

Doubtful  Word  Locations  95 


LOCATING  OTHER  WORDS  IN  YOUR  DOCUMENT 

On  occasion  you  may  wish  to  locate  various  words  in  your 
document.  Any  word  on  the  ARDS  WORD  LIST  can  be  located  in  your 
document  by  contacting  the  ARDS  support  personnel  at  617-271-7864. 
The  output  looks  similar  to  the  ARDS  DOUBTFUL  WORD  LOCATIONS  listing 

or.  p-„*e  95. 


UPDATING  THE  PROJECT  DICTIONARY 

Occasionally  good  words  will  be  included  on  the  ARDS  DOUBTFUL 
WORDS  listing.  The  good  words  on  this  listing  can  be  added  to  your 
project  dictionary.  If  you  plan  to  perform  an  analysis  on  future 
versions  of  your  document,  the  project  dictionary  should  be  updated. 
To  update  your  project  dictionary,  contact  the  ARDS  support 
personnel  at  617-271-7864. 
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SECTION  5 


ON-LINE  DOCUMENT  ANALYSIS 


This  section  of  the  manual  describes  the  on-line  interface  of 
Document  Analysis.  In  this  section,  you  will  find  the 
characteristics  of  the  on-line  interface  and  prints  of  some  of  the 
displays  you  will  encounter.  You  will  also  find  the  results  of 
selecting  various  options  shown  in  the  displays. 

The  on-line  interface  is  intended  for  the  local  ESD/MITRE  user 
who  is  not  familiar  with  the  UNIX  system.  The  on-line  interface  can 
provide  help  at  any  point  by  entering: 

h  <CR> 

In  addition  to  reviewing  hard  copies  of  the  Document  Analysis 
products,  the  on-line  Document  Analysis  user  can  review  these 
products  on-line.  The  on-line  interface  also  provides  for  the 
updating  of  your  project  dictionary. 

DISPLAY  CONVENTIONS 

The  on-line  interface  has  been  designed  for  easy  use  by  people 
who  are  not  familiar  with  UNIX.  The  following  formatting 
conventions  have  been  used  in  its  design  to  improve  usability: 

The  display  label  (usually  the  series  of  option  letters 
entered  to  get  you  to  a  display)  is  displayed  In  the  top, 
left-hand  corner  of  the  screen. 

The  name  of  the  document  selected  for  review  is  displayed 
to  the  right  of  the  display  label. 

Instructions  for  data  entry  or  option  selection  are  In 
the  bottom  lines  of  the  display. 

Error  messages  will  appear  in  the  line  before  the 
i nst  met i ons . 

Information  messages  will  appear  on  the  line  before  error 
messages . 


A  beep  is  sounded  when  a  display  output  has  been  completed  and  the 
system  is  ready  for  user  Input. 


INPUT  CHARACTER  LIMITATION 


The  following  special  characters  cannot  be  used  In  any  Input  to 
the  system  through  the  Document  Analysis  on-line  Interface: 

*&()[]?@l~;<>-n:# 1 

Therefore,  the  names  and  titles  of  documents  that  you  supply  when 
you  are  loading  a  document  into  Document  Analysis  must  not  contain 
any  of  these  above  characters. 


DOCUMENT  REPLACEMENT 

If  a  document  being  loaded  is  assigned  the  same  "name .version" 
as  a  previously  loaded  document,  then  the  previously  loaded  document 
and  alL  Document  Analysis  products  associated  with  it  are  destroyed. 


USING  ON-LINE  DOCUMENT  ANALYSIS 

You  can  request  an  analysis  of  your  document  from  a  VT100  or 
VT103  terminal  by  executing  the  command: 

ards  <CR> 

;'t:e  :is:..:iv  ot.  paf’e  J1  will  be  shown.  The  remainder  of  this 

section  contains  prints  of  some  of  the  displays  you  will  encounter 
in  the  on-line  Interface  and  the  results  of  selecting  the  various 
options  shown. 
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ARDS  OPTIONS  LIST 


s  =  Specification  generation 
d  =  Document  analysis 
c  =  Comment  Management 
e  =  Exit  from  ARDS 
h  =  Help 


Select  option:  | 


INPUT 

d 


31 


SAMPLE  DISPLAY 
page  32 


o  spadb.o.2 

ARDS  OPTIONS 

d  =  Document  management  (loading,  analysis,  selection,  deletion) 
u  =  Uord  check  for  typos,  spelling  errors 
p  =  Paragraph  check  for  misnumbering,  format  errors 
r  =  Reference  check,  paragraphs  and  external 
t  =  Table  of  contents 

h  =  Helpful  explanation  of  ARDS  capabilities 
c  =  Command  entry 
e  =  Exit  from  ARDS 

Select  option: 


INPUT 


P 

r 

t 

h 


SAMPLE  DISPLAY 


page  33 

38 

39 
AO 

45 

46 

47 

OPERATION 

Exit  from  ARDS 
Document  Analysis 


32 
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od 

ARDS  DOCUMENT  MANAGEMENT 

Four  document  *anage*ent  services,  are  available".  1 

1  = 

Loading  a  new  document  into  ARDS  files 

a  = 

Analyzing  a  new  document,  once  loaded 

s  - 

Selecting  an  analyzed  document  for  review 

d  = 

Deleting  an  old  document  fro*  files 

P p \ i j rn  t  r< 

ARDS  Options,  or 

Select  d  o 

:u«?nt  nanagenent  service! 

INPUT 

SAMPLE  DISPLAY 

1 

page  34 

a 

35 

8 

36 

d 

37 

RETURN 

32 
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ARDS  DOCUMENT  : SAD  INS 
Conf  irn  Spe '  :  f : .  .it i  gn 

'  i  n  a  \  .  uou  must  confirm  the  new  document  specification.  or  qou  maq 

enter  3  code  to  request  that  any  item  be  -handed  : n  n  imp  d  date.  etc. 

L1  NIX  source  file:  ul /spadoc/ards/spadb.  o.  2 

ARDS  document  record 

Same:  spadb.o 

•  e  r  s  i  o  n :  2 
cate:  At  81 

T:tte:  Preliminary  Performance  And  Design  Requirements  For  The 

'JSAF  Space  Defense  Operations  Center  Basic  Alternative 


Mer5demer*.  ;r 

code  to  change1  document  specification: 


INPUT 

n 

v 

d 

t 

c 


OPERATION 

Permits  changing  of  document  name 
Permits  changing  of  version  number 
Permits  changing  of  document  date 
Permits  changing  of  document  title 
Confirms  document  specification 
SAMPLE  DISPLAY 


RETURN 


page  33 


caa 

APDS  DOCUMENT  ANALYSIS 
I  up) ement at  ion 

Document  spadb.o.2  has  been  loaded  and  is  available  for  analysis. 

Saxe. Version;  spadb.o.2:  Loaded  Mon  Jun  1  11:27:21  EDT  1 9° 1 
Date:  6/1  '81 

title!  Preliminary  Performance  And  Design  Requirement;  ror  The 

USAF  Space  Defense  Operations  Center  Basic  Alternative 

Based  on  the  document  size  of  184  pages,  the  computer  charge  for  ARDS 
analysis  will  be  appro* imately  till  during  daylight  hours,  and  4  4  to 
do  the  same  job  at  night  (login  after  h  pm).  Indicate  when  you  want 
to  implement  document  analysis. 

l  -  Immediately 

n  =  Nighttime 

d  -  Ie;ef  document  analysis  indefinitely 
>  -  larcel  document  analysis  and  delete  document 

deat'sd  analysis  implementation: 


OPERATION 

Implements  the  analysis  of 
specified  document  Immediately 

Implements  the  analysis  of 
specified  document  after  normal 
work  hours 

Defers  the  analysis  of  specified 
document  indefinitely 

Cancels  the  analysis  of  the 
specified  document;  deletes 
specified  document 

SAMPLE  DISPLAY 


INPUT 

i 

n 

d 

x 


RETURN 


page  33 


ods  spadb.o.2 

ARDS  DOCUMENT  SELECTION 


Currently  selected  document  is 

Name . Vers  ion :  spadb.o.2;  Loaded  Tue  Mar  31  10:14:36  EST  1981 

Date:  2/28/81 

Title:  Preliminary  Performance  And  Design  Requirements  for  The 

USAF  Space  Defense  Operations  Center  Basic  Alternative 


Stored  documents  include 
spadb.o.2 


Peturn  to  Document  Management,  or 

Enter  name. version  of  selected  new  document  here: 


INPUT  OPERATION 

name. version  Selects  specified  document  for 

analysis 

SAMPLE  DISPLAY 

RETURN  page  33 


36 
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Odd 


ARDS  DOCUMENT  DELETION 
Document  Choice 


Stored  documents  include 

To  delete  a  document  fro*  ARDS  files  requires  two  steps: 

(1)  Enter  here  the  document  name. 

(2)  You  will  then  review  the  full  document  specification  and 
be  ashed  to  confirm  deletion. 


Return  to  Document  Management,  or 

Enter  name. version  of  document  to  be  deleted: 


INPUT 


name .version 


RETURN 


OPERATION 


Indicates  the  document  to  be  deleted 
SAMPLE  DISPLAY 
page  33 
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ow  sp3db.o.2 

ARDS  WORD  CHECK 

A  word  check  for  this  document  has  been  completed. 

Summarized  results  show: 

5544  different  words,  including 

5055  recognized  words,  probably  correct 
117  doubtful  words,  possibly  wrong 
372  acronyms,  recognized  or  doubtful 

To  review  these  words,  select  desired  category: 

r  =  Recognized  words 
d  =  Doubtful  words 
a  =  Acronyms 

p  -  Printout  list  of  all  words 


Return  to  ARDS  Options,  or 
Select  category  for  word  check: 


OPERATION 

Permits  on-line  review  of  recognized 
words 

Permits  on-line  review  of  doubtful 
words.  Subsequent  operations  permits 
the  update  of  the  project  dictionary. 

Permits  on-line  review  of  acronyms 


p  75  80  85  92 
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op  spadoc.2 

ARDS  PARAGRAPH  CHECK 

A  paragraph  check  for  this  document  has  been  conpleted. 
8  errors  in  paragraph  numbering  have  been  detected. 

To  review  these  errors,  select  desired  output  node: 

P  =  Printout 

d  =  Display  < recommended  for  expert  users  only) 


f 

I 

Peturn  to  ARDS  Options,  or 
ji  Select  desired  output: 


INPUT  SAMPLE  PRINTOUT 

P  page  57 

OPERATION 

d  Permits  on-line  review  of  the  paragraph 

numbering  errors. 
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ARDS  REFERENCE  CHECK 


5Padb.o.2 


Two  types  of  reference  checking  are  available: 

p  =  Paragraph  references,  i.e.,  those  internal  to  this  document 

e  =  External  references,  i.e.,  those  to  other  documents 
(listed  in  Section  2.0  of  system  specifications) 


Options,  or 
s  check : 


SAMPLE  DISPLAY 
page  41 
42 


INPUT 

P 

e 


RETURN 


32 


ARDS  REFERENCE  CHECK 
Paragraph  Referencing 


A  checF  of  internal  paragraph  referencing  in  this  document  has  been  completed 

Three,  lists  are  available.  You  can  select  a  particular  list  for  review, 
or  choose  to  print  all  three. 

w  -  Wrong  paragraph  references 

bg  -  paragraphs  referred  to  BY  others 

to  u  paragraphs  that  refer  TO  others 

c  --  intent  all  three 

c-  ■- i  'i' ::r'i  output* 


OPERATION 

Permits  on-line  review  of  wrong 
paragraph  references. 

Permits  on-line  review  of  paragraphs 
referred  TO  BY  others. 

Permits  on-line  review  of  paragraph 
that  refers  TO  others. 

SAMPLE  PRINTOUTS 

page  59 


INPUT 

w 

by 

to 


P 


RETURN 
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ARDS  REFERENCE  CHECK 
External  Referencing 


A  check  of  external  references  in  this  document  has  been  completed, 
'wo  outputs  are  available.’ 

a  -  All  references,  in  the  reference  list  and  in  the  text 

d  =  Discrepant  references  only,  i.e.,  those  where  a  reference 
in  the  text  does  not  appear  in  the  reference  list, 
or  vice  versa 


Sa+eron<;e  Check,  or 
?'ral  referencing  output: 


INPUT 


SAMPLE  DISPLAY 


a 


page  A3 


d 


44 


RETURN 


40 


42 


I 


:-?3  5P 3db . 0 . 2 


ARDS  EXTERNAL  REFERENCING 
A 1 1  External  References 


153  external  references  have  been  found  in  this  document  mrlud 

39  in  the  reference  list,  and 
Ilf  in  the  text 

To  review  all  references,  listed  by  location  in  the  document, 
request  printout. 


"  :.-‘rrrz.  3“+' erenc md,  or 

r. .  - :  ••  c--  .r’  :s*  1 


INPUT 

RETURN 


P 


SAMPLE  DISPLAY 
page  42 
SAMPLE  PRINTOUT 
page  66 
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ARDS  EXTERNAL  REFERENCING 
Discrepant  References 


-ea  sradt.o.c 

4  discrepancies  in  external  referencing  have  been  detected,  inclining 

10  in  the  reference  list,  but  not  in  the  text 
24  in  the  text,  but  not  in  the  reference  list 

o  review  these  discrepancies,  listed  alphabetically  by  reference  nawe 
elect  desired  output  node: 

p  =  Printout 

d  =  Display  ( recoxnended  for  expert  users  only) 


tennai  Referencing,  or 

ed  output: 


INPUT  SAMPLE  DISPLAY 

RETURN  page  42 

SAMPLE  PRINTOUT 

P  page  66 

OPERATION 


d 


Permits  on-line  review  of  discrepant 
external  references. 


ARDS  TABLE  OF  CONTENTS 

A  table  of  contents  for  this  document  has  been  generated. 
ACC  entries  were  found. 

To  review  these  entries,  select  desired  output  node: 

P  :  Printout 

d  -  Display  (recommended  for  expert  users  only) 


Di  1 1 ;  r.\  or 


INPUT  SAMPLE  DISPLAY 

RETURN 

P 

d 


45 


page  32 

SAMPLE  PRINTOUT 
page  50 
OPERATION 

permits  on-line  review  of  the  table 
of  contents 


I 


oh 

ARDS  OPTIONS  HELP 

The  display  of  ARDS  options  is  the  hone  base  to  wmch  you  can  return 
fro*  any  step  in  a  transaction  sequence.  You  can  always  return  to  Options 
by  entering  an  "o'  (but  without  the  quotation  narks). 

At  any  step  in  a  transaction  sequence  you  can  also  enter  an  "h“  to 
request  help  pertinent  to  that  particular  transaction.  A  help  display 
is  a  smple  digression.  Any  entry  will  return  you  to  the  display  you  just 
left.  In  this  case  you  will  return  to  the  ARDS  Options  display. 

If  you  want  a  helpful  explanation  for  a  specific  option,  return  to 
the  Options  display,  and  then  enter  an  option  code  followed  by  *h‘:  *dh‘ 
for  an  explanation  of  document  aanageaent ,  *wh*  for  an  explanation  of  word 
check,  etc. 


Return: 


INPUT 

RETURN 
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OPERATION 

Return  to  Previous  Display 


l 


::  sea 

dt 

APDS  COMMAND  tNTR- 

.'ode  + 

Qua  1  if ler 

Js 

na*e. version 

selects  new  document  for  review 

g 

p 

prints  ail  words  in  document 

gr 

p 

prints  recognized  words 

wd 

p 

or  d 

doubtful  words 

p 

or  d 

possible  acronyms  (not  yet  implemented 

wd  1  a 

p 

or  d 

locations  of  all  doubtful  words 

wd  1  b 

P 

or  d 

locations  of  bad  doubtful  words 

wd  1  S 

P 

or  d 

locations  of  selected  doubtful  words 

p 

p 

or  d 

paragraph  numbering  errors 

•‘pg 

p 

or  d 

wrong  paragraph  references 

~PCw! 

p 

or  d 

paragraphs  referred  to  BT  others 

•'  L  *  j 

c 

or  j 

paragraphs  that  refer  TO  others 

•  C 

c 

prints  all  three  paragraph  referencing  1 

ists 

’  t*  r 

c 

cr:nts  all  external  references 

c 

-  --  s 

discrepancies  in  external  referencing 

c 

--  d 

babie  of  contents 

r  ^ 

-  ; 

:  -- .  :  I-ct  10 

r  ; 

-  *  *  -  r  j  f  *”  t  A 

INPUT 

SAMPLE  DISPLAY 

ds  name .version 

page  47 

SAMPLE  PRINTOUT 

wp 

page  75 

wrp 

80 

wdp 

92 

wap 

85 

wdlap 

95 

wdlbp 

95 

wdlsp 

95 

PP 

57 

rpwp 

65 

rpbyp 

62 

rptop 

59 

rpp 

59,62,65 

reap 

68 

redp 

67 

tp 

51 

47 


SECTION  6 


DOCUMENT  ANALYSIS  PRODUCTS 


This  section  contains  examples  of  the  products  generated  by 
Document  Analysis.  The  examples  were  generated  using  a  preliminary 
version  of  the  SPADOC  Type  A  system  specification. 


BANNERS 

The  first  page  of  the  Document  Analysis  products  is  a  banner 
page.  The  banner  page  Indicates  the  account  in  which  the  analysis 
was  performed  and  the  project  to  which  the  computer  time  was 
charged.  In  addition,  the  banner  page  also  indicates  the  name  of 
the  document  analyzed,  the  date  the  document  was  last  modified,  and 
the  name  and  date  the  product  file  was  generated. 
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TABLE  OF  CONTENTS 


The  Document  Analysis  generated  Table  of  Contents  lists  the 
paragraphs  by  number  and  title.  If  page  numbers  were  properly 
defined  in  your  document,  the  Table  of  Contents  will  also  contain 
page  numbers.  Otherwise,  the  number  "1"  is  used  as  a  page  number 
throughout  the  Table  of  Contents.  The  first  five  pages  of  SPADOC 
table  of  contents  begins  on  the  next  page. 


'>0 


i 


Nr  r  .  df  (IS  Spa'll 


PARAGRAPH  CHECK 


For  documents  with  numbered  paragraphs,  the  Document  Analysis 
generated  Paragraph  Check  lists  paragraphs  that  are  not  in  correct 
ascending  numeric  sequence.  To  assist  you  in  finding  the 
paragraph(s)  in  error,  this  listing  indicates  the  line  number,  the 
page  number,  and  the  actual  line  that  is  in  error. 


reference  check 


Document  Analysis  generates  two  types  of  Reference  Check 
products:  Paragraph  References  and  External  References. 

Paragraph  References 

For  documents  with  numbered  paragraphs,  where  one  paragraph  may 
reference  another  by  number,  Document  Analysis  can  help  you  ensure 
that  those  references  are  correct.  Three  listings  are  generated: 

Paragraphs  that  refer  to  other  paragraphs.  See  page 

59. 

Paragraphs  referred  to  by  others  (useful  when  some 
paragraph  numbers  in  the  document  may  be  changing). 

See  page  62. 

Wrong  references,  l.e.,  to  paragraphs  that  do  not 
exist.  See  page  65. 

NOTE:  Document  Analysis  will  occasionally  list  some  other  numbers 

in  the  document,  perhaps  a  measurement,  as  if  it  were  a  wrong 
paragraph  number. 


dr<ts  Sp Sftb.Q.r’ 


11:57  1981  /u5/hkr/ards/*pa<Jt>.o .?  Pago 


External  References 


If  section  2  of  a  document  with  numbered  paragraphs  contains  a 
list  of  External  References,  a  Discrepant  References  listing  will  be 
generated.  This  listing  shows  the  references  in  the  text  which  do 
not  appear  in  the  references  lists,  and  vice  versa.  This  listing  is 

found  on  page  67 . 

A  list  of  all  External  References  are  found  on  page  66.  A 
code  of  "NL"  indicates  the  reference  was  not  found  in  the  list  and  a 
code  of  "NT"  indicates  the  reference  was  not  found  in  the  text.  If 
the  reference  was  found  in  the  reference  list  and  in  the  text,  the 
code  is  blank. 

NOTE:  Document  Analysis  may  occasionally  not  recognize  an  intended 

reference  if  its  format  has  been  garbled;  for  example,  MIL  STD  490 
as  opposed  to  MIL-STD-490. 


6t 
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ds  spadh.c  .  t  f'dQr 
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WORD  CHECK 


The  Document  Analysis  Word  Check  capability  generates  five 
types  of  reports.  The  first  report  in  this  group  is  the  Word  List. 
The  Word  List  contains  a  frequency  listing  of  all  words  used  in  your 
document.  The  first  five  pages  of  the  Word  List  generated  from  a 
preliminary  version  of  the  SPADOC  specification  are  found  on  pages 
75  through  79- 

The  first  five  pages  from  the  list  of  recognized  words  begin  on 

page  80.  This  listing  is  generated  with  on-line  analyses  only. 

A  list  of  possible  acronyms  begins  on  page  85. 

A  list  of  doubtful  words  begins  on  page  92  and  the  location 
of  these  doubtful  words  begins  on  page  95.  If  words  listed  on  the 

doubtful  word  list  are  in  fact  good  words,  they  can  be  added  to 
project  dictionary.  Contact  the  ARDS  support  group  for  project 
dictionary  update  assistance  at  617-271-7864. 

A  location  listing  can  be  generated  for  any  word  found  on  the 
word  list. 
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APPENDIX  A 


HOW  TO  GET  THE  FINAL  WORD-11  DOCUMENT 


The  purpose  of  this  appendix  is  to  provide  procedures  for 
generating  the  final  document  in  WORD-11.  If  you  do  not  plan  to  use 
any  of  the  Document  Analysis  products  as  part  of  your  final  document, 
it  is  not  necessary  to  implement  these  procedures. 


MERGE  ALL  FILES  OF  THE  DOCUMENT 

If  the  document  contains  several  files,  merge  all  of  the  files 
into  a  single  document.  File  the  document  after  each  file  is  pulled 
into  the  merged  version  by  hitting  the  "GOLD"  key  and  the  "f"  key. 


VERIFY  CURRENT  PAGE  (CP)  SETTINGS 

Verify  the  text  size  set  in  the  Editor  Menu.  Then  page  through 
the  document  to  check  the  page  breaks.  This  is  done  by  hitting  the 
"GOLD"  key  and  the  "blue  page"  key.  Fix  all  improper  page  breaks  and 
file  ("GOLD"  key  and  "f"  key)  the  document.  File  your  document  often 
so  that  your  efforts  will  not  be  wasted  in  the  event  of  a  system 
crash. 


INSERT  TABLES  AND  FIGURES 

If  your  document  has  tables  and/or  figures,  you  must  insert  them 
or  leave  the  required  number  of  blank  pages  for  later  insertion.  If 
you  have  both  tables  and  figures  in  your  document,  you  must  execute 
the  insertion  procedures  twice,  once  for  tables  and  once  for  figures. 

Start  at  the  beginning  of  the  document  by  hitting  "GOLD" 
key  and  then  the  "t"  key. 

Search  for  the  first  reference  to  table  or  figure 
keyword  in  your  document  via  the  "search"  function  of 
WORD-11  (hit  "GOLD"  and  keys). 

Put  a  "new”  page  marker  by  pressing  the  "GOLD"  key  and 
the  "n"  key.  Merge  the  table  or  figure  into  the 
document.  Make  sure  another  "new"  page  marker  ("GOLD" 
key  and  "n"  key)  follows  the  table  or  figure.  Also  make 
sure  the  text  that  follows  the  table  has  the  proper 
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ruler.  If  you  just  want  to  leave  a  blank  page,  press 
"GOLD"  and  "n"  keys,  "RETURN"  key,  and  "GOLD"  and  "n" 
keys  again. 

Back  up  In  the  document  to  the  top  of  the  page  that 
contained  the  reference  point.  You  need  to  do  this 
because  sometimes  there  will  be  references  to  two  tables 
on  the  same  page.  If  you  do  net  back  up,  you  may  miss 
the  first  reference  to  the  next  table. 

Repeat  these  steps  for  each  table  that  you  must  merge 
into  the  final  product.  File  the  document  depressing 
the  "GOLD”  and  the  "f”  keys. 

PRINT  THE  DOCUMENT 

Order  a  printout  from  the  LINEPRINTER  to  check  your  printout 
before  printing  the  final,  "camera-ready"  version  of  the  document 
Check  to  make  sure  these  settings  are  correct  in  the  Print  Menu: 

FO  -  LINEPRINTER 

PH  -  YES 

AP  -  NO 

SE  -  NO 

PO  -  0 

EX  -  0 

Make  sure  that  the  formula: 

CP  +  BM  +  TM  -  PS 

is  correct.  The  recommended  settings  for  the  LINEPRINTER  and 
letter-quality  printers  are  as  follows: 

CP  48  BM  6  TM  12  PS  66 

The  recommended  settings  for  the  the  6670  is  as  follows: 

CP  48  BM  4  TM  10  PS  62 


CHECK  THE  RESULTS 

Check  the  LINEPRINTER  printout.  If  everything  is  all  right, 
you  are  ready  to  transfer  the  document  for  an  analysis.  See 
appendix  B,  PROCEDURES  FOR  TRANSFERRING  WORD-11  DOCUMENTS. 


APPENDIX  B 


PROCEDURES  FOR  TRANSFERRING  WORD-11  DOCUMENTS 


Two  methods  of  transferring  documents  from  WORD-11  to  Document 
Analysis  are  available.  The  first  uses  the  WORD-11 /UNIX  direct  link 
communications  capability  provided  by  the  BCC.  The  second  uses 
standard  nine-track  tape  as  the  exchange  medium.  In  either  case, 
the  documents  to  be  transferred  must  first  be  converted  into 
printer-image  form  in  WORD-11. 


DOCUMENT  PREPARATION 


This  section  describes  the  procedures  for  creating  a  printer 
image  of  a  document  in  WORD-11.  The  following  conventions  are  used 
in  these  procedures  to  show  what  you  must  key  in  at  your  terminal: 


<CR>  means  carriage  return  using  the  RETURN 

key. 

[description]  means  enter  the  kind  of  information 
described  between  the  brackets.  For 
example,  [document  name]  means  key  in  the 
name  of  the  document. 


c  means  key  in  a  lower  case  "c",  i.e.,  any 

letters  or  words  or  numbers  not  enclosed 
In  brackets  should  be  keyed  in  exactly  as 
shown. 


<CTRL> 


means  hold  down  the  CTRL  key  while  entering 
the  letter  that  follows. 


Login  to  WORD-11 

To  login  to  WORD-11  from  a  VT100  or  VT103  terminal,  hit  the 
"RETURN”  key.  If  you  are  prompted  with: 


MITRE  SYSTEM  #? 


enter: 


[system  number]  <CR> 
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For  example: 


22  <CR> 

If  you  are  prompted  with: 

Enter  MITRENET  Service  Name: 

see  the  Bedford  Computer  Center  Facility  Manual  for  "login" 
instructions . 

If  you  need  help,  call  the  User  Support  Center  at  617-271-2222. 
When  prompted  with  a  message  like  the  following: 

RSTS  V7.0-07  WORD-11  (WD2 )  KB62  02-Sept-82  04:05  PM 

If 


enter  your  account  number  followed  by  a  carriage  return.  You  will 
then  be  prompted  with: 


Password : 

Enter  the  password  of  your  account. 

After  the  login,  the  broadcast  messages  will  be  displayed. 
After  reading  the  broadcast  message(s),  enter  a  carriage  return. 

Select  the  Word  Processing  Option  (WP) 

Following  the  broadcast  message(s),  the  Office  Systems  Menu 
will  be  displayed.  From  this  menu,  select  the  Word  Processing 
option: 

wp  <CR> 

At  this  point,  the  Main  Menu  of  the  Word  Processing  options  will  be 
displayed . 

Select  the  File(s)  To  be  Transferred 


Look  at 
transferred . 
you  may  omit 


the  WORD-11  index  to  determine  which  files  are  to  be 
If  you  already  know  which  files  are  to  be  transferred, 
the  next  command.  To  look  at  the  index,  enter: 


i  <CR> 
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On  a  copy  of  appendix  C  list  the  number  of  all  of  the  documents  that 
are  to  be  transferred.  This  sheet  will  serve  as  a  check  to  ensure 
that  all  documents  have  been  transferred.  Also  record  the  number  of 
the  account  into  which  you  are  currently  logged.  You  will  need  the 
account  number  later  if  you  are  not  transferring  the  document  via 
tape.  Now  get  back  to  the  Main  Menu.  This  is  done  hitting  the 
"gold"  key  and  then  entering  the  letter  "m” . 

Create  a  Printer-Image  File  of  the  Document 


From  the  Main  Menu,  select  the  print  option  and  enter  the 
number  of  the  document  whose  printer- image  you  are  going  to  create. 
This  is  done  by  entering: 

p  [document  name  or  number]  <CR> 

You  are  now  in  the  Print  Menu  and  ready  to  create  a  printer- 
image  file  of  the  document.  The  document  must  have  the  following 
characteristics: 

Contain  no  table  of  contents,  requirements  verification 
matrix,  list  of  figures,  list  of  illustrations,  etc.,  if 
they  have  numbers  that  look  like  paragraph  numbers  and 

Be  a  single-spaced  document  with  double  spacing  between 
paragraphs . 

If  you  are  producing  the  final  document  with  the  intent  of 
using  the  Document  Analysis  generated  table  of  contents  as  part  of 
your  document,  the  document  must  have  additional  characteristics: 

Have  Arabic  page  numbers  that  are  centered  and 
contain  no  special  characters. 

Have  page  numbers  that  allow  for  figures  and  tables  not 
included  in  the  document.  See  appendix  A,  HOW  TO  CET  THE 
FINAL  WORD-11  DOCUMENT,  for  additional  information. 

The  printer  setting  displayed  must  be  changed  to  meet  the 
requirements  of  Document  Analysis.  See  figure  B-l.  To  save  the 
current  printer  setting,  enter  the  "ss"  command  followed  by  a  single 
digit.  For  example, 

ss  9  <CR> 

CAUTION:  If  this  account  is  used  by  more  than  one  person,  you 

should  check  to  see  which  numbers  are  available  for  saving 
printer  settings. 


—  Print  Menu  — 


Form  or  Direct  Output  FO/DT  LINEPRINTER  (Form) 


Printer  margin  indent 

PM 

0 

First  page  to  print 

FR 

1 

Lines  in  top  margin 

TM 

2 

Last  page  to  print 

TO 

0 

Lines  in  bottom  margin 

BM 

2 

Bin  select 

BS 

0 

Lines  per  page 

PS 

66 

Copies  to  be  printed 

CP 

1 

Automatic  page  breaking 

AP 

YES 

Stop  every  page 

SE 

NO 

Initial  page  number 

IP 

1 

Create  Index 

IN 

NO 

Characters  per  inch 

PI 

10 

Create  Table  of  1  ents 

TC 

NO 

Wide  printing  margin 

WM 

0 

Print  header 

PH 

NO 

Extra  half-line  spacing 

EX 

0 

Delete  after  prir  ?. 

DE 

NO 

Print  extra  dark 

DA 

NO 

Letter  Quality  pi 

LQ  NO 

Underline  spaces 

US 

NO 

Print  priority 

PR 

0 

Include  change  bars 

CB 

NO 

Printer  option 

P0 

0 

Type  the  letters 

and 

value 

and  press  RETURN. 

Type  YES  and  press  RETURN  if  all  settings  are  correct. 


Figure  B-l.  WORD-11  Printer  Settings  for  Document  Analysis 
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Now  change  the  printer  settings  to  adhere  to  figure  B-l .  To 
make  a  change  to  the  printer  settings,  type  the  two-letter 
Identifier  followed  by  a  space  and  the  argument  "YES",  "NO"  or  a 
number  depending  on  the  type  of  parameter  required.  After  all 
changes  have  been  made,  save  the  new  printer  setting  by  entering  the 
"ss"  command  followed  by  a  single  digit  not  used  above.  For 
example , 


ss  8  <CR> 

The  printer-image  file  is  created  by  entering  the  direct  output, 
"dt",  option  with  a  file  name.  The  Document  Analysis  naming  2 

convention  is  "ards"  followed  by  a  period  and  the  document  number. 

If  the  document  is  "25",  the  name  of  the  printer-image  file  is 
"ards . 25 " . 

To  indicate  the  name  of  the  printer- image  file  to  WORD-1’, 
enter : 

dt  ards . [document  number]  <CR> 


For  example: 


dt  ards.  25  <CR> 

To  indicate  that  all  settings  are  correct  and  that  you  are  ready  to 
create  the  printer  image  of  your  document,  enter: 

yes  <CR> 

When  the  printer-image  file  has  been  created,  you  will  be  returned 
to  the  Main  Menu.  Entering  "yes”  created  the  printer-image  file  and 
stored  the  document  with  the  new  printer  settings.  At  this  time  you 
should  restore  the  original  printer  settings.  This  is  done  by 
entering: 

p  [document  name  or  number]  <CR> 


2  The  file  name  must  consist  of  one  to  six  alphanumeric  characters, 
a  period  plus  a  one  to  three  alphanumeric  character  extension. 
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This  retrieves  the  document  with  the  new  printer  settings.  Restore 
the  original  printer  settings  by  entering  the  following  commands: 

rs  9  <CR> 

ss  <CR> 

no  <CR> 

If  you  wish  to  create  another  printer-image  file,  select  the 
print  option  with  your  document  name  or  number.  If  the  number  8  was 
used  to  store  the  Document  Analysis  required  printer  setting,  enter: 

rs  8  <CR> 

Now  enter  the  "dt"  command.  For  example: 

dt  ards.25  <CR> 


Enter : 


yes  <CR> 

to  indicate  that  you  are  ready  to  create  the  printer-image  file. 
Record  the  printer-image  file  name  on  your  copy  of  appendix  C. 

After  the  printer- image  file  has  been  created,  restore  the  printer 
settings  as  indicated  in  the  previous  paragraphs.  Continue  this 
process  until  a  printer-image  file  has  been  created  for  each  part  of 
your  document . 

Exit  WORD- 11 


After  the  printer-image  files  have  been  created  for  each  part 
of  your  document  that  is  to  be  transferred,  exit  the  WORD-11  Word 
Processing  mode  by  entering: 


f  <CR> 

You  are  now  out  of  the  WORD-11  Word  Processing  mode  and  in  the 
Office  Systems  Menu.  At  this  point,  logout  out  of  WORD-1 1  by 
entering: 


lo  <CR> 

If  the  documents  are  to  be  transferred  by  the  direct  link,  continue 
with  the  procedures  described  below  in  FILE  TRANSFER.  Otherwise, 


follow  the  procedures  under  TAPE  TRANSFER.  If  your  document  Is  150 
pages  or  less  in  length,  use  of  the  FILE  TRANSFER  capability  is 
recommended . 


FILE  TRANSFER 
Login  to  UNIX 

After  the  WORD-11  logout  statistics  have  been  displayed,  slowly 
hit  the  "BREAK"  key  four  times.  Now  hit  the  "RETURN"  key.  If  you 
are  prompted  with: 


MITRE  System  //? 


enter: 


1  <CR> 

for  the  UNIX  system.  If  you  are  prompted  with: 

Enter  MITRENET  Service  Name: 


enter : 


unix  <CR> 

for  the  UNIX  system.  When  prompted  with: 

login : 

enter  your  UNIX  login  name  followed  by  a  carriage  return.  Then 
enter  the  password  of  the  account  if  requested. 

Transfer  a  Copy  of  the  Printer-Image  File  to  UNIX 

You  can  transfer  a  copy  of  the  printer-image  file  created  in 
WORD-il  to  your  UNIX  account  via  the  call  UNIX  program,  "cu" .  To 
transfer  the  WORD-11  printer-image  file  to  UNIX  via  "cu" ,  enter; 

cu  <CR> 


You  will  be  prompted  with: 


MITRE  System  0? 


or 
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Enter  MITRENET  Service  Name: 


You  are  now  ready  to  log  in  to  WORD-11.  See  Login  to  WORD-11, 
at  the  beginning  of  this  appendix.  Following  the  broadcast 
message(s),  the  Office  Systems  Menu  will  be  displayed.  At  this 
point,  enter  the  RSTS  access  code.  The  RSTS  access  code  can  be 
obtained  from  the  WORD-11  system  programmer.  To  contact  the  WORD-11 
system  programmer,  call  the  User  Support  Center  (617-271-2222)  at 
the  MITRE-Bedford  Computer  Center.  You  are  now  ready  to  transfer  a 
copy  of  the  printer-image  file  to  UNIX.  To  transfer  a  file,  enter: 

~>[UNIX  document  name]  <CR> 

where  "UNIX  document  name"  is  the  name  the  document  will  have  in 
UNIX.  After  entering  this  command,  every  character  displayed  or 
entered  at  your  terminal  will  be  transferred  to  the  specified  UNIX 
file.  From  your  copy  of  appendix  C,  enter  the  name  of  the  first 
printer-image  file  to  be  transferred  in  the  command  below: 

pip  [printer-image  file  name]  <CR> 

You  will  see  the  printer-image  file  displayed  at  your  terminal,  line 
by  line.  When  prompted  with: 


Ready 

your  printer- image  file  has  been  transferred  to  UNIX. 

If  you  have  other  files  to  be  transferred,  enter  the  “pip" 
command  again  with  the  next  printer-image  file  name  from  your  copy 
of  appendix  C.  Continue  this  process  until  all  of  the  printer-image 
files  have  been  transferred  to  UNIX. 

Exit  the  Call  UNIX  Program 

After  all  printer-image  files  have  been  transferred,  enter: 


to  exit  RSTS  and  return  to  UNIX. 
Clean  Up  the  Transferred  File 


When  you  are  back  in  UNIX,  you  must  remove  the  lines  beginning 
with  "pip”  and  "Ready"  in  the  transferred  file.  To  do  this,  enter 
the  command  line: 

grep  -v  '“Ready$'  [document  name]  I  grep  -v  '“pip  '  >  [file  name] 
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K* 
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where  "document  name"  is  the  name  of  the  transferred  document  file 
in  UNIX  and  "file  name"  is  the  name  of  a  new  file  in  UNIX  without 
the  "Ready"  prompt  and  the  "pip"  command.  You  are  now  ready  to 
prepare  the  transferred  document  for  Document  Analysis. 

To  review  a  file  from  either  list,  via  the  RAND  editor,  enter: 
r  [file  name]  <CR> 


When  prompted  with: 

Enter  r  and  file  name  to  review,  m  for  more  transfers,  or 
Enter  e  to  exit: 

see  section  4,  BATCH  DOCUMENT  ANALYSIS,  for  an  explanation  of  how  to 
use  the  RAND  editor. 

If  more  transfers  or  re-transfers  are  desired,  enter: 

m  <CR> 

To  exit  the  transfer  program  when  all  desired  transfers  have 
been  done,  enter: 


e  <CR> 


TAPE  TRANSFER 
Get  a  Tape 

Call  the  Bedford  Computer  Center  desk  (617-271-3379)  and  tell 
the  person  that  answers  that  you  wish  to  transfer  a  file  from 
WORD-11  to  UNIX.  If  the  person  taking  the  call  cannot  handle  your 
request,  ask  to  speak  to  someone  who  can.  When  you  have  a  person 
that  can  help  you,  ask  him  to  mount  an  "unprotected"  scratch  tape  on 
the  WORD-11  system  which  has  your  stored  documents.  Be  sure  that 
you  get  the  number  or  name  of  the  scratch  tape. 

Exit  WORD-11  and  Enter  RSTS 


The  printer-image  file(s)  has  been  created  and  you  are  now 
ready  to  copy  the  file(s)  to  tape.  Exit  the  WORD-11  Word  Processing 
mode  by  entering: 


f  <CR>  (exit  WORD-11) 
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You  are  now  out  of  the  WORD-11  Word  Processing  mode  and  In  the 
Office  Systems  Menu.  At  this  point,  enter  the  RSTS  access  code.  The 
RSTS  access  code  can  be  obtained  from  the  WORD-11  system  programmer. 
To  contact  the  WORD-11  system  programmer,  call  the  User  Support 
Center  (617-271-2222)  at  the  Bedford  Computer  Center.  If  you  should 
need  to  get  back  into  the  WORD-11  system,  enter: 

wordll  <CR> 

Copy  the  Printer-Image  File  to  Tape 

Make  sure  that  the  tape  is  mounted  and  the  tape  is  at  its  load 
point  by  entering  the  command: 

run  prog: rewind 


If  you  are  prompted  with: 


Ready 

your  tape  is  mounted.  If  any  of  the  following  messages  appear: 
?Magtape  select  error  at  line  10  or 
?Device  not  available  at  line  10  or 
DEVICE  HUNG  OR  WRITE  LOCK. . . 

it  indicates  that  your  tape  has  not  yet  been  mounted.  Wait  a  few 
minutes  and  try  again. 

Copy  your  printer-image  file(s)  to  tape  by  entering  the 
command : 


run  prog:wrtape  <CR> 

When  prompted  with: 

What  file  will  be  written  to  tape? 

enter  the  name  of  the  printer-image  disk  file  (file  just  created 
with  "dt")  to  be  copied  to  tape.  If  several  printer-image  files  for 
one  document  are  to  be  transferred,  they  should  be  put  on  the  same 
tape  in  the  proper  sequence.  When  prompted  again  with: 

What  file  will  be  written  to  tape? 
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enter  the  next  printer-image  file  name.  If  the  error  message: 


DEVICE  HUNG  OR  WRITE  LOCK... 

appears,  call  the  Bedford  Computer  Center  desk  (617-271-3379).  Ask 
if  your  tape  has  a  "write''  ring.  If  the  tape  does  not  have  a 
"write"  ring,  have  one  inserted  and  again  enter  these  commands: 

run  prog: rewind  <CR> 

run  prog:wrtape  <CR> 

After  the  last  printer-image  file  has  been  copied,  enter: 

exit  <CR> 

to  terminate  the  program.  Your  tape  is  now  ready  for  transferring 
your  document  to  UNIX. 

If  you  wish  to  see  what  is  actually  on  the  tape,  enter  the 
command : 


run  prog:seetape  <CR> 

when  prompted  with  "Ready".  When  you  have  seen  enough,  enter: 

<CTRL>  c 

After  the  document  has  been  successfully  transferred  to  UNIX, 
you  should  remove  all  of  the  created  printer-image  files.  See 
DELETING  PRINTER-IMAGE  FILES  IN  RSTS  at  the  end  of  this  appendix. 

Logout  of  RSTS 


To  logout  of  the  RSTS  system,  enter: 

bye/f  <CR> 


Login  to  UNIX 

After  the  WORD-11  logout  statistics  have  been  displayed,  slowly 
hit  the  "BREAK"  key  four  times.  Now  hit  the  "RETURN"  key.  If  you 
are  prompted  with: 


MITRE  System  #? 
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enter: 


1  <CR> 

for  the  UNIX  system.  If  you  are  prompted  with: 

Enter  MITRENET  Service  Name: 


enter: 


unix  <CR> 

for  the  UNIX  system.  When  prompted  with: 

login: 

enter  your  UNIX  login  name  followed  by  a  carriage  return.  Then 
enter  the  password  of  the  account  if  requested. 

Copy  the  Tape  to  Disk 

Mount  your  tape  in  UNIX  by  executing  command: 

mntape  [tape  number)  <CR> 

For  example: 

mntape  5035  <CR> 

When  the  command  is  entered,  you  will  immediately  get  a  message 
indicating  the  drive  on  which  the  tape  will  be  mounted.  Wait  until 
the  operator  gives  you  a  ready  message  before  executing  the  "dd" 
command.  If  you  do  not  receive  the  message  within  five  minutes, 
call  the  operator  at  617-271-3379. 

The  "dd"  command  will  copy  the  WORD-11  tape  to  disk  creating 
one  disk  file.  To  copy  the  tape  execute: 

dd  lf-/dev/mt{ tape  drive  number]  of»[document  name] 


where  "tape  drive  nudber"  is  the  drive  on  which  your  tape  is 
mounted,  "document  name"  is  the  name  you  have  given  the  document  to 
be  analyzed.  The  "dd"  command  will  respond  with  the  number  of 
records  copied  in  and  the  number  of  records  written  to  the  output 
file  when  the  tape  is  finished  copying. 
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Dismount  the  Tape 

To  dismount  your  tape,  enter: 

umntape  [tape  drive  number]  <CR> 

where  "tape  drive  number"  is  the  drive  on  which  your  tape  is 
mounted . 


DELETING  PRINTER-IMAGE  FILES  IN  RSTS 

Follow  the  procedures  for  logging  into  WORD-11  as  previously 
discussed.  When  in  the  Office  Systems  Menu,  enter  the  RSTS  access 
code.  The  RSTS  access  code  can  be  obtained  by  calling  the  User 
Support  Center  at  617-',',l-2222.  When  prompted  with: 

Ready 

you  can  delete  the  printer- image  files  by  entering: 

pip  <CR> 


When  prompted  with: 


» 

enter  the  name  of  the  printer- image  file  to  be  deleted,  followed  by 
"/de".  When  the  last  file  has  been  deleted,  exit  the  "pip"  program 
by  entering  '<CTRL>  c".  For  example: 

pip  <CR> 

9  ards. 25/de  <CR> 

9  ards. 26/de  <CR> 

9  <CTRL>  c 

will  delete  the  printer-image  files,  "ards. 25"  and  "ards. 26". 
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APPENDIX  C 


WORD- 11  TO  UNIX  DOCUMENT  WORKSHEET 


Document  name: 


WORD-11  Account: 


Transfer  Date: 


WORD-11  Files 

Indicate  when  completed 
dt  File  Sequence  Written  dt  File 


*  Name  "dt"  file  "ards.”  followed  by  file  number,  e.g.,  "ards.21". 
**  Indicate  the  order  the  "dt"  files  are  to  be  written  to  tape. 


UNIX  File  Name  given  when  tape  read  into  UNIX:  _ 

(maximum  of  seven  alphanumeric  characters) 
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APPENDIX  D 


PROCEDURES  FOR  TRANSFERRING  DEC  WS/78  OR  DECMATE  DOCUMENTS 


Transferring  a  document  generated  on  either  a  DEC  WS/78  or 
DECmate  word-processing  system  is  an  interactive  procedure  using  the 
communications  capability  of  the  system.  The  following  procedure 
assumes  use  of  a  DEC  system  with  the  communications  option  and  a 
system  diskette  with  the  "CX"  communications  configured  as  described 
in  appendix  E. 

Depending  on  the  exact  type  of  connection  (direct  cable 
connection,  acoustic  coupler  modem,  or  push-button/ 
telephone-connected  modem),  the  procedure  for  establishing  the 
connection  will  vary. 

The  following  conventions  are  used  in  these  procedures  to  show 
what  you  must  key  in  at  your  terminal. 


<CR>  means  carriage  return  using  the  RETURN 

key. 

[description]  means  enter  the  kind  of  information 
described  between  the  brackets;  for 
example,  [document  name]  means  key  in 
the  name  of  the  document. 


c  means  key  in  a  lower  case  "c",  i.e.,  any 

letters  or  words  or  numbers  not  enclosed 
in  brackets  should  be  keyed  in  exactly 
as  shown. 


<CTRL> 


Means  hold  down  the  "CTRL"  key  while 
entering  the  letter  that  follows. 


EDIT  THE  DOCUMENT 

Before  the  document  is  transferred,  make  sure  the  left  margin 
is  zero.  This  is  done  by  reviewing  the  print  option.  To  review  the 
print  option,  enter  the  Print  Menu  by  entering  the  command: 

GOLD  m 


p  [document  number  or  name]  <CR> 


When  In  the  Print  Menu,  the  current  print  settings  will  be 
displayed.  The  print  settings  should  be  changed  to  meet  the 
requirements  of  Document  Analysis.  To  save  the  current  print 
settings,  enter  the  "ss”  command  followed  by  a  single  digit.  For 
example , 

ss  9  <CR> 

Now  change  the  print  settings  to  adhere  to  figure  D-l.  If  you  need 
help  in  changing  the  print  settings,  contact  the  BCC  User  Support 
Center  at  (617-271-2222).  The  asterisks  (*)  in  figure  D-l  indicate 
the  minimum  value  the  print  setting  can  have.  After  all  of  the 
changes  have  been  made,  save  the  printer  settings  by  entering  the 
"ss"  command  followed  by  a  single  digit  not  used  above,  for  example: 

ss  8  <CR> 

The  single  digit  represents  the  Document  Analysis  print  settings 
name.  If  you  should  have  to  transfer  another  document  for  Document 
Analysis  processing,  use  the  same  digit. 

GET  THE  TRANSFER  FORMAT 

Get  the  Main  Menu  and  Systems  Options  Menu  by  entering  the 
commands  below.  The  "so"  command  can  be  entered  after  "GOLD  m"  even 
though  the  "so"  command  is  not  currently  displayed  on  the  terminal 
screen. 

GOLD  m 
so  <CR> 

After  the  System  Options  Menu  has  been  displayed,  secure  the 
correct  transfer  format  by  entering  the  command: 

cd  0.6  <CR>  (WS/78 ) 
or 

cd  0.2  <CR>  (DECmate) 

This  step  assumes  the  system  disk  has  the  "CX"  communication 
option  setup,  the  same  as  the  standard  Comment  Management  system 
disk.  See  appendix  E  for  the  procedure  to  set  the  “CX" 
communications  configuration  for  UNIX. 

Get  the  Main  Menu  and  request  the  Character  Transmission 
Package  by  entering  the  following  commands: 


—PRINT  MENU— 


These  are  the  current  settings  for  printing  document: 

*10  characters  per  inch  (pitch)  66  total  lines  per  page 

1  copy  will  be  printed  *  2  lines  in  the  top  margin 

1  is  the  number  on  the  first  page  *  2  lines  in  the  bottom  margin 
1  is  the  first  page  printed  0  spaces  in  the  left  print  margi 

0  spaces  between  columns 

shadow  print  no 

0  extra  half-line  space  between  lines 
do  not  stop  before  every  page 
automatically  break  into  pages 
do  not  print  extra  dark 
do  not  print  with  two  wheels 
document  destination  is  LQP 

If  all  settings  are  correct  type  YES,  otherwise  type  NO,  then  press 
RETURN. 


Figure  D-l.  DECmate-WS/ 78  Printer  Settings  for  Document  Analysis 
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COLD  m 
cx  <CR> 


GET  INTO  UNIX 

The  procedures  below  describe  the  use  of  a  Bell  Data  Set  212A. 
If  you  are  using  some  other  type  of  data  set,  adjust  the  procedures 
accordingly.  If  you  have  questions,  contact  the  ARDS  support 
personnel  at  617-271-7864.  When  the  Communications  Menu  appears 
with  the  option  "KH  HS"  at  the  bottom  of  the  screen: 

Press  the  "TALK"  button  on  the  telephone  and  dial  the 
appropriate  telephone  extension. 

When  the  computer  answers  with  a  high-pitched  tone, 
press  the  "DATA"  button  on  the  telephone  and  hang  up  the 
phone . 

Enter  a  carriage  return.  (Two  may  be  required). 

If  you  are  prompted  with: 

MITRE  System  //? 


enter: 


1  <CR  > 

for  the  UNIX  system.  If  you  are  prompted  with: 

Enter  MITRENET  Service  Name: 


enter : 


unix  <CR> 

for  the  UNIX  system.  When  prompted  with: 


login  : 

you  are  now  ready  to  login  to  UNIX.  Enter  your  login  name  followed 
by  a  "<CR>"  and  your  password  followed  hv  a  "<CR>".  If  you  should 
get  the  message  "Login  incorrect",  try  the  login  procedures  again. 


* 
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TRANSFER  THE  FILE 


Transfer  the  file  to  UNIX  by  entering  the  commands  below  when 
prompted  with  "%". 

cat  >  [document  name]  <.CK> 

This  command  will  store  the  transferred  file  in  UNIX  with  the  file 
name  of  "document  name"  in  your  current  directory.  To  initiate  the 
transfer,  enter: 

\r  (no  <CR>) 

which  escapes  back  to  the  DECmate-WS/78  operating  system. 

When  the  Comtr  ions  Menu  appears  witli  "KS  HS"  at  the 

bottom,  enter: 


dh  <CR> 

This  changes  the  bottom  line  of  the  screen  to  KS  HS  DH.  The 
system  will  then  prompt  for  the  DECmate-WS/78  number  (name)  oi  the 
document.  Enter  the  document  number  or  name  followed  by  a  carriage 
return : 


(document  number  or  name]  <CR> 

At  this  point,  the  document  file  will  be  displayed  on  the 
screen  of  the  terminal  as  it  is  transmitted,  line  by  line. 

After  the  last  line  of  the  document  has  been  displayed,  enter: 

<CR> 

You  can  append  another  document  to  the  one  just  transferred  by 
entering  the  following  command  sequence: 

\r  (no  <CR>) 

<CR> 

[document  number  or  name]  <CR> 

Continue  this  process  until  all  of  the  files  have  been  transferred. 

After  the  last  line  of  the  last  document  has  been  displayed, 
enter : 


» 
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<CR> 


<CTRL>  d  (this  terminates  the  file  input) 

After  all  of  the  documents  have  been  transferred,  enter 

logout  <CR> 

When  the  login  message  is  displayed,  enter: 

\r  (returns  to  DECmate  or  WS/78) 
When  the  communication  option  display  appears,  enter: 

GOLD  m 

to  return  to  the  DECmate  or  WS./78  Main  Menu. 


This  concludes  the  transfer  procedure. 


APPENDIX  E 


DEC  WS/78  AND  DECMATE  CX  COMMUNICATIONS  CONFIGURATION 


There  are  two  parts  to  configuring  the  "CX"  communications 
option:  1)  creating  a  protocol  description  file  on  the  system  dis 

and  2)  setting  the  asynchronous  communications  characteristics  on 
the  System  Options  Menu. 

The  following  file  must  be  created  on  the  DF.Cmate  or  WS/78 
system  disk: 


send 
eo  1  c  r 

This  file  can  be  assigned  any  file  number  but  the  following 
convention  has  been  used  in  the  past: 

O.b  on  WS/78 
or 

0.2  on  DKCmate 

The  procedure  for  setting  the  "CX"  communications  options  for 
compatibility  with  an  acoustic  coupler  connection  to  UNIX  follows: 

Enter : 


GOLD  m 

to  obtain  the  Main  Menu.  Then  enter: 

so  <CR> 

to  obtain  the  System  Options  Menu.  Enter: 

c.c  <CR> 

to  change  the  characteristics  of  the  communications  line.  When 
in  the  Communication  Settings  Menu,  set  the  options  as  follows: 
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standard 

No 

B  300 
no 
8 
1 


Communications  Protocol 

Buffer  Control 

Baud  Rate 

Parity 

Data  Bits 

Stop  Bits 


If  the  current  selections  do  not  agree  with  the  above  list, 
the  selections  can  be  changed  using  the  procedures  described  In: 

Word  Processing  System  Communications  Options  User's  Manual, 
Appendix  B  -  Changing  the  Communications  Characteristics. 

DEC  document  number  AA-K666A-TA. 


APPENDIX  F 


DOCUMENT  ANALYSIS  SUMMARY  SHEET 


This  sheet  summarizes  the  steps  necessary  to  analyze  a  document  in  ARDS. 
It  Is  assumed  that  the  user  has  a  UNIX  account  and  knows  how  to  log  onto  the 
system . 

TAILOR  DOCUMENT  FOR  PROCESSING 

See  ARDS  User's  Manual:  Document  Analysis,  section  3,  TAILORING  DOCUMENT 
FOR  ARDS  ANALYSIS. 

TRANSFER  DOCUMENT  TO  UNIX 

Transfer  the  document  from  Its  word  processor  to  UNIX  if  the  document  Is 
not  in  UNIX.  See  appendices  B  and  D  for  transfer  procedures  for  WORD-ll 
and  DEC  stand-alone  word  processors.  Contact  the  ARDS  support  team  at 
617-271-7864  for  transfers  from  other  word  processors. 

EXECUTE  ARDS  DOCUMENT  PREPARATION  PROCRAM 

doc . prep 


ANALYZE  DOCUMENT 

Batch  Document  Analysis 

To  generate  Document  Analysis  products  and  produce  a  printout  and/or  a 
UNIX  file  containing  the  products,  enter: 

batch  .ards 


On-line  Document  Analysis 

To  analyze  documents  on-line  or  to  review  Document  Analysis  products 
on-line,  enter: 


ards 


OBTAIN  DOCUMENT  ANALYSIS  PRODUCTS 
Hard  Copy 

Document  Analysis  hard  copy  products  can  be  obtained  at  the  MITRE-Bedf ord 
Computer  Center  desk. 

Te rmlna 1 


If  the  analysis  was  requested  on-line,  most  Document  Analysis  products 
can  be  viewed  from  your  terminal. 

Ft  le 

The  "batch .ards”  command  optionally  produces  a  UNIX  file  containing  all 
of  the  document  analysis  products.  The  name  of  the  file  produced  is  the 
name  of  the  document  file  followed  by  "all”. 
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APPENDIX  G 


DOCUMENT  ANALYSIS  ERROR  AND  INFORMATION  MESSAGES 


DOCUMENT  MANAGEMENT 
Error  Messages 

UNIX  file  not  found 

The  specified  document  file  was  not  found. 

_  not  found 

The  specified  file  was  not  found. 

not  recognized 

The  data  entered  was  not  recognized. 

_  should  not  be  more  than  8  characters 

The  name  of  the  document  :ile  cannot  be  more  than  8  characters. 

_  should  be  a  one  or  two  digit  number 

The  version  number  cannot  be  more  than  2  digits. 

_  should  be  numbers  for  month/day/year 

The  date  should  be  of  the  form  mm/dd/yy. 

_  should  be  n ,  v,  d,  t,  or  c 

The  type  of  change  to  be  made  must  be  indicated  by  one  oi  tn 
letters  listed. 

Can  only  select  analyzed  documents. 

A  document  must  be  analyzed  before  it  can  be  selected. 


Information  Messages 
*Option  not  yet  implemented 

The  selected  option  has  not  yet  been  implemented.  Select 
another  option. 

♦Document  _ . _  is  already  in  files 

A  document  with  this  name  and  version  number  already  exists  in 
your  ARDS  directory. 
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PARAGRAPH  CHECK 


Error  Messages 


_  not  recognized 

The  data  entered  was  not  recognized. 

Information  Messages 


*Print  of  paragraph  numbering  errors  can  be  picked  up  at  the 
Bedford  Computer  Center. 

*Paragraph  check  has  now  begun. 


REFERENCE  CHECK 
Error  Messages 


not  recognized 

The  data  entered  was  not  recognized. 

Information  Messages 

*Print  of  Referred  to  BY  list  can  be  picked  up  at  the  Bedford 
Computer  Center. 

*Print  of  Refers  TO  list  can  be  picked  up  at  the  Bedford  Computer 
Center . 

*Print  of  Wrong  Paragraph  Reference  list  can  be  picked  up  at  the 
Bedford  Computer  Center. 

*Print  of  paragraph  reference  lists  can  be  picked  up  at  the  Bedford 
Computer  Center. 

*Paragraph  reference  check  has  now  begun. 

*F.xternal  reference  check  has  now  begun. 

*Print  of  all  references  can  be  picked  up  at  the  Bedford  Computer 
Center . 

♦Print  of  discrepant  references  can  be  picked  up  at  the  Bedford 
Computer  Center. 
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TABLE  OF  CONTENTS 


Error  Messages 

_  not  recognized 

The  data  entered  was  not  recognized. 

Information  Messages 

*Print  of  table  of  contents  can  be  picked  up  at  the  Bedford  Computer 
Center. 

*Table  of  contents  generation  has  now  begun. 
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